Метод IDataset::Locate

Устанавливает текущей запись с определенным набором значений полей.

IDL

[id(103441)]
HRESULT Locate(
    [in] BSTR KeyFields, 
    [in] VARIANT KeyValues, 
    [out, retval] VARIANT_BOOL* Value
);

Параметры

Параметры	Описание
KeyFields	Имена полей набора данных
KeyValues	Значения полей набора данных
Value	Возвращаемое значение

Возвращаемое значение

"True", если на текущей странице существует запись с указанным набором значений полей.

Описание

Устанавливает текущей запись с определенным набором значений полей на текущей странице.

В параметре "KeyFields" передаются имена полей набора данных, по значениям которых будет выполнен поиск. Разделителем имен в строке является ";".

В параметре "KeyValues" передается таблица значений полей, имена которых указаны в параметре "KeyFields".

Метод возвращает "True", если в наборе данных существует запись с указанными значениями полей, и делает текущей первую найденную запись. Иначе возвращает "False".

Примечания

№	Описание
1.	Поиск записи с заданными параметрами выполняется только на текущей странице.